package cc.magicjson.example.demo.algorithm.arary;

/**
 * {@link}
 * <p>
 * 给定一个 n 个元素有序的（升序）整型数组 nums 和一个目标值 target  ，写一个函数搜索 nums 中的 target，如果目标值存在返回下标，否则返回 -1。
 * 示例 1:
 * 输入: nums = [-1,0,3,5,9,12], target = 9
 * 输出: 4
 * 解释: 9 出现在 nums 中并且下标为 4
 * 示例 2:
 * 输入: nums = [-1,0,3,5,9,12], target = 2
 * 输出: -1
 * 解释: 2 不存在 nums 中因此返回 -1
 * 提示：
 * 你可以假设 nums 中的所有元素是不重复的。
 * n 将在 [1, 10000]之间。
 * nums 的每个元素都将在 [-9999, 9999]之间。
 * #算法公开课
 *
 * @author <a href="mailto:it_magicjson@163.com">MagicJson</a>
 * @since 1.0.0
 */
public class BinarySearchSolution {

	public int binarySearch(int[] arr, int target) {
		//  采用区间得二分法查找
		// 定义区间：满足该区间[left,right) 在该区间内进行二分查找
		// 健壮校验
		if (arr == null || arr.length == 0) {
			return -1;
		}
		int left = 0;
		int right = arr.length;
		while (left < right) {
			int mid = left + ((right - left) >> 1);
			if (arr[mid] > target) {
				right = mid;
			} else if (arr[mid] < target) {
				left = mid + 1;
			} else {
				return mid;
			}
		}
		return -1;
	}
}
